{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# 21 - Meta Learners\n",
    " \n",
    " \n",
    "Just to recap, we are now interested in finding treatment effect heterogeneity, that is, identifying how units respond differently to the treatment. In this framework, we want to estimate\n",
    " \n",
    "$\n",
    "\\tau(x) = E[Y_i(1) − Y_i(0)|X] = E[\\tau_i|X]\n",
    "$\n",
    " \n",
    "or, $E[\\delta Y_i(t)|X]$ in the continuous case. In other words, we want to know how sensitive the units are to the treatment. This is super useful in the case where we can't treat everyone and need to do some prioritization of the treatment, for example when you want to give discounts but have a limited budget. \n",
    " \n",
    "Previously, we saw how we could transform the outcome variable $Y$ so that we can plug it in a predictive model and get a Conditional Average Treatment Effect (CATE) estimate. There, we had to pay a price in terms of variance increase. That's something we see a lot in Data Science. There isn't a single best method because each one has its downsides and upsides. For that reason, it is worth learning about many techniques so you can trade-off one for the other depending on the circumstances. In that spirit, this chapter will focus on giving more tools for you to have at your disposal. \n",
    " \n",
    "![img](data/img/meta-learners/learned-new-move.png)\n",
    " \n",
    "Meta learners are a simple way to leverage off-the-shelf predictive machine learning methods in order to solve the same problem we've been looking at so far: estimating the CATE. Again, none of them is the single best one and each one has its weakness. \n",
    "I'll try to go over them, but keep in mind that this stuff is highly dependent on the context. Not only that, meta-learners deploy predictive ML models which can vary from linear regression and boosted decision trees to neural networks and gaussian processes. The success of the meta learner will be also highly dependent on what machine learning method it uses as its components. Oftentimes you just have to try out many different things and see what works best. "
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "metadata": {
    "ExecuteTime": {
     "end_time": "2023-07-27T11:43:09.109336Z",
     "start_time": "2023-07-27T11:43:07.076775Z"
    },
    "tags": [
     "hide-input"
    ]
   },
   "outputs": [],
   "source": [
    "import pandas as pd\n",
    "import numpy as np\n",
    "from matplotlib import pyplot as plt\n",
    "import seaborn as sns\n",
    "from nb21 import cumulative_gain, elast"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Here, we will use the same data we had before, regathing investment advertisement emails. Again, the goal here is to figure out who will respond better to the email. There is a little twist, though. This time, we will use non-random data to train the models and random data to validate them. Dealing with-non random data is a much harder task, because the meta learners will need to debias the data **AND** estimate the CATE."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "metadata": {
    "ExecuteTime": {
     "end_time": "2023-07-27T11:43:09.141766Z",
     "start_time": "2023-07-27T11:43:09.111209Z"
    }
   },
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<style scoped>\n",
       "    .dataframe tbody tr th:only-of-type {\n",
       "        vertical-align: middle;\n",
       "    }\n",
       "\n",
       "    .dataframe tbody tr th {\n",
       "        vertical-align: top;\n",
       "    }\n",
       "\n",
       "    .dataframe thead th {\n",
       "        text-align: right;\n",
       "    }\n",
       "</style>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>age</th>\n",
       "      <th>income</th>\n",
       "      <th>insurance</th>\n",
       "      <th>invested</th>\n",
       "      <th>em1</th>\n",
       "      <th>em2</th>\n",
       "      <th>em3</th>\n",
       "      <th>converted</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>0</th>\n",
       "      <td>44.1</td>\n",
       "      <td>5483.80</td>\n",
       "      <td>6155.29</td>\n",
       "      <td>14294.81</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>1</td>\n",
       "      <td>0</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1</th>\n",
       "      <td>39.8</td>\n",
       "      <td>2737.92</td>\n",
       "      <td>50069.40</td>\n",
       "      <td>7468.15</td>\n",
       "      <td>1</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>2</th>\n",
       "      <td>49.0</td>\n",
       "      <td>2712.51</td>\n",
       "      <td>5707.08</td>\n",
       "      <td>5095.65</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>1</td>\n",
       "      <td>1</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>3</th>\n",
       "      <td>39.7</td>\n",
       "      <td>2326.37</td>\n",
       "      <td>15657.97</td>\n",
       "      <td>6345.20</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>4</th>\n",
       "      <td>35.3</td>\n",
       "      <td>2787.26</td>\n",
       "      <td>27074.44</td>\n",
       "      <td>14114.86</td>\n",
       "      <td>1</td>\n",
       "      <td>1</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "    age   income  insurance  invested  em1  em2  em3  converted\n",
       "0  44.1  5483.80    6155.29  14294.81    0    0    1          0\n",
       "1  39.8  2737.92   50069.40   7468.15    1    0    0          0\n",
       "2  49.0  2712.51    5707.08   5095.65    0    0    1          1\n",
       "3  39.7  2326.37   15657.97   6345.20    0    0    0          0\n",
       "4  35.3  2787.26   27074.44  14114.86    1    1    0          0"
      ]
     },
     "execution_count": 2,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "test = pd.read_csv(\"./data/invest_email_rnd.csv\")\n",
    "train = pd.read_csv(\"./data/invest_email_biased.csv\")\n",
    "train.head()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Our outcome variable is conversion and our treatment is email-1. Let's create variables to store those along with the features $X$ we will use to search for heterogeneity in the treatment effect."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 3,
   "metadata": {
    "ExecuteTime": {
     "end_time": "2023-07-27T11:43:09.145795Z",
     "start_time": "2023-07-27T11:43:09.143325Z"
    }
   },
   "outputs": [],
   "source": [
    "y = \"converted\"\n",
    "T = \"em1\"\n",
    "X = [\"age\", \"income\", \"insurance\", \"invested\"]"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## S-Learner (aka, the Go-Horse Learner)\n",
    " \n",
    "The first learner we will use is the S-Learner. This is the simplest learner we can think of. We will use a single (hence the S) machine learning model $M_s$ to estimate\n",
    " \n",
    "$\n",
    "\\mu(x) = E[Y| T, X]\n",
    "$\n",
    " \n",
    "To do so, we will simply include the treatment as a feature in the model that tries to predict the outcome Y. \n",
    "\n",
    "```note\n",
    "Although I'll use a regressor to estimate $E[Y| T, X]$, since the outcome variable is binary, you could also use a classifier. Just be sure to adapt the code so that the model outputs probabilities instead of the binary class, 0, 1.\n",
    "```"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 4,
   "metadata": {
    "ExecuteTime": {
     "end_time": "2023-07-27T11:43:09.297975Z",
     "start_time": "2023-07-27T11:43:09.147885Z"
    }
   },
   "outputs": [],
   "source": [
    "from lightgbm import LGBMRegressor\n",
    "\n",
    "np.random.seed(123)\n",
    "s_learner = LGBMRegressor(max_depth=3, min_child_samples=30)\n",
    "s_learner.fit(train[X+[T]], train[y]);"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Then, we can make predictions under different treatment regimes. The difference in predictions between the test and control will be our CATE estimate\n",
    " \n",
    "$\n",
    "\\hat{\\tau}(x)_i = M_s(X_i, T=1) - M_s(X_i, T=0)\n",
    "$\n",
    " \n",
    "If we put that in a diagram, here is what it would look like\n",
    " \n",
    "![img](data/img/meta-learners/s-learner.png)\n",
    " \n",
    "Now, let's see how we can implement this learner in code."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 5,
   "metadata": {
    "ExecuteTime": {
     "end_time": "2023-07-27T11:43:09.335612Z",
     "start_time": "2023-07-27T11:43:09.299470Z"
    }
   },
   "outputs": [],
   "source": [
    "s_learner_cate_train = (s_learner.predict(train[X].assign(**{T: 1})) -\n",
    "                        s_learner.predict(train[X].assign(**{T: 0})))\n",
    "\n",
    "s_learner_cate_test = test.assign(\n",
    "    cate=(s_learner.predict(test[X].assign(**{T: 1})) - # predict under treatment\n",
    "          s_learner.predict(test[X].assign(**{T: 0}))) # predict under control\n",
    ")"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "To evaluate this model, we will look at the cumulative gain curve in the test set. I'm also plotting the gain curve in the train. Since the train is biased, this curve cannot give any indication if the model is good, but it can point us out if we are overfitting to the training set. When this happens, the curve in the train set will be super high. If you want to see what that looks like, try replacing the `max_depth` parameter from 3 to 20."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 6,
   "metadata": {
    "ExecuteTime": {
     "end_time": "2023-07-27T11:43:09.555976Z",
     "start_time": "2023-07-27T11:43:09.337074Z"
    },
    "tags": [
     "hide-input"
    ]
   },
   "outputs": [
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<Figure size 432x288 with 1 Axes>"
      ]
     },
     "metadata": {
      "needs_background": "light"
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "gain_curve_test = cumulative_gain(s_learner_cate_test, \"cate\", y=\"converted\", t=\"em1\")\n",
    "gain_curve_train = cumulative_gain(train.assign(cate=s_learner_cate_train), \"cate\", y=\"converted\", t=\"em1\")\n",
    "plt.plot(gain_curve_test, color=\"C0\", label=\"Test\")\n",
    "plt.plot(gain_curve_train, color=\"C1\", label=\"Train\")\n",
    "plt.plot([0, 100], [0, elast(test, \"converted\", \"em1\")], linestyle=\"--\", color=\"black\", label=\"Baseline\")\n",
    "plt.legend()\n",
    "plt.title(\"S-Learner\");"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "![img](data/img/meta-learners/not-great-not-terrible.jpeg)\n",
    " \n",
    "As we can see from the cumulative gain, the S-learner, although simple, can perform okay on this dataset. One thing to keep in mind is that this performance is highly particular to this dataset. Depending on the type of data that you have, the S-learner might do better or worse. In practice, I find that the S-learner is a good first bet for any causal problem, mostly due to its simplicity. Not only that, the S-learner can handle both continuous and discrete treatments, while the rest of the learners in this chapter can only deal with discrete treatments.\n",
    " \n",
    "The major disadvantage of the S-learner is that it tends to bias the treatment effect towards zero. Since the S-learner employs what is usually a regularized machine learning model, that regularization can restrict the estimated treatment effect. ‪Chernozhukov‬ et al (2016) outline this problem using simulated data:\n",
    " \n",
    "![img](data/img/meta-learners/zero-bias-s-learner.png)\n",
    " \n",
    "Here, they plot the difference between the true causal effect (red outline) and the estimated causal effect, $\\tau - \\hat{\\tau}$,  using an S-learner. The estimated causal effect is heavily biased.\n",
    " \n",
    "Even worse, if the treatment is very weak relative to the impact other covariates play in explaining the outcome, the S-learner can discard the treatment variable completely. Notice that this is highly related to the chosen ML model you employ. The greater the regularization, the greater the problem. One attempt to fix that is the next learner we will see."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## T-Learner\n",
    " \n",
    "The T-learner tries to solve the problem of discarding the treatment entirely by forcing the learner to first split on it. Instead of using a single model, we will use one model per treatment variable. In the binary case, there are only two models that we need to estimate (hence the name T):\n",
    " \n",
    "$\n",
    "\\mu_0(x) = E[Y| T=0, X]\n",
    "$\n",
    " \n",
    "$\n",
    "\\mu_1(x) = E[Y| T=1, X]\n",
    "$\n",
    " \n",
    "Then, at prediction time, we can make counterfactual predictions for each treatment and get the CATE as follows.\n",
    " \n",
    "$\n",
    "\\hat{\\tau}(x)_i = M_1(X_i) - M_0(X_i)\n",
    "$\n",
    " \n",
    "Here is the diagram of this learner\n",
    " \n",
    "![img](data/img/meta-learners/t-learner.png)\n",
    "\n",
    "\n",
    "Now, enough about theory. Let's code this up."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 7,
   "metadata": {
    "ExecuteTime": {
     "end_time": "2023-07-27T11:43:09.659555Z",
     "start_time": "2023-07-27T11:43:09.557322Z"
    }
   },
   "outputs": [],
   "source": [
    "np.random.seed(123)\n",
    "\n",
    "m0 = LGBMRegressor(max_depth=2, min_child_samples=60)\n",
    "m1 = LGBMRegressor(max_depth=2, min_child_samples=60)\n",
    "\n",
    "m0.fit(train.query(f\"{T}==0\")[X], train.query(f\"{T}==0\")[y])\n",
    "m1.fit(train.query(f\"{T}==1\")[X], train.query(f\"{T}==1\")[y])\n",
    "\n",
    "# estimate the CATE\n",
    "t_learner_cate_train = m1.predict(train[X]) - m0.predict(train[X])\n",
    "t_learner_cate_test = test.assign(cate=m1.predict(test[X]) - m0.predict(test[X]))"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 8,
   "metadata": {
    "ExecuteTime": {
     "end_time": "2023-07-27T11:43:09.858681Z",
     "start_time": "2023-07-27T11:43:09.661105Z"
    },
    "tags": [
     "hide-input"
    ]
   },
   "outputs": [
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<Figure size 432x288 with 1 Axes>"
      ]
     },
     "metadata": {
      "needs_background": "light"
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "gain_curve_test = cumulative_gain(t_learner_cate_test, \"cate\", y=\"converted\", t=\"em1\")\n",
    "gain_curve_train = cumulative_gain(train.assign(cate=t_learner_cate_train), \"cate\", y=\"converted\", t=\"em1\")\n",
    "plt.plot(gain_curve_test, color=\"C0\", label=\"Test\")\n",
    "plt.plot(gain_curve_train, color=\"C1\", label=\"Train\")\n",
    "plt.plot([0, 100], [0, elast(test, \"converted\", \"em1\")], linestyle=\"--\", color=\"black\", label=\"Baseline\")\n",
    "plt.legend();\n",
    "plt.title(\"T-Learner\");"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The T-learner also performs OK on this dataset. The test performance doesn't look much different from what we got with the S-learner. Perhaps because the treatment is not that weak. Also, we can see that the training performance is much higher than the testing performance. This indicates the model is overfitting. This can happen because we are fitting each model on only a subset of the data. With less data points, the model is probably learning some noise. \n",
    " \n",
    "The T-Learner avoids the problem of not picking up on a weak treatment variable, but it can still suffer from regularization bias. Consider the following situation, taken from Kunzela et al, 2019. You have lots of data for the untreated and very few data for the treated, a pretty common case in many applications, as treatment is often expensive. Now suppose you have some non linearity in the outcome Y, but the **treatment effect is constant**. We can see what happens in the following image\n",
    " \n",
    "![img](data/img/meta-learners/t-learner-problem.png)\n",
    " \n",
    "Here, since we have very few treated observations, $M_1$ will be a very simple model (linear in this case) to avoid overfitting. $M_0$ will be more complicated, but that's OK because the abundance of data prevents overfitting. This is all reasonable from a Machine Learning perspective. However, if we use these models to compute the cate $\\hat{\\tau}=M_1(X) - M_0(X)$, the linearity of $M_1(X)$ minus the non linearity of $M_0(X)$ will result in a nonlinear CATE (blue line minus red line), which is wrong, since the CATE is constant and equal to 1 in this case. \n",
    " \n",
    "What happens here is that the model for the untreated can pick up the non linearity, but the model for the treated cannot, because we've used regularization to deal with a small sample size. Of course, you could use less regularization on that model, but then the small sample size will cause you to overfit. Seems like we are caught between a rock and a hard place. To solve this problem, we can use an X-learner, proposed in the same paper by Kunzela et al. "
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## X-Learner\n",
    " \n",
    "The X-learner is significantly more complex to explain than the previous learner, but its implementation is quite simple, so don't worry. The X-Learner has two stages and a propensity score model. The first one is identical to the T-learner. First, we split the samples into treated and untreated and fit a ML model for the treated and for control.\n",
    " \n",
    "$\n",
    "\\hat{M}_0(X) \\approx E[Y| T=0, X]\n",
    "$\n",
    " \n",
    "$\n",
    "\\hat{M}_1(X) \\approx E[Y| T=1, X]\n",
    "$\n",
    " \n",
    "Now, things start to take a turn. For the second stage, we impute the treatment effect for the control and for the treated using the models above\n",
    " \n",
    "$\n",
    "\\hat{\\tau}(X, T=0) = \\hat{M}_1(X, T=0) - Y_{T=0}\n",
    "$\n",
    " \n",
    "$\n",
    "\\hat{\\tau}(X, T=1) = Y_{T=1} - \\hat{M}_0(X, T=1)\n",
    "$\n",
    " \n",
    "Then, we fit two more models to predict those effects\n",
    " \n",
    "$\n",
    "\\hat{M}_{\\tau 0}(X) \\approx E[\\hat{\\tau}(X)|T=0]\n",
    "$\n",
    " \n",
    "$\n",
    "\\hat{M}_{\\tau 1}(X) \\approx E[\\hat{\\tau}(X)|T=1]\n",
    "$\n",
    " \n",
    "If we apply this on the image we've shown before, $\\hat{\\tau}(X, T=0)$, the imputed treatment effect on the untreated, would be the red crosses and the red dashed line would be $\\hat{M}_{\\tau 0}(X)$. Notice that this model is wrong. Because $\\hat{\\tau}(X, T=0)$ was made using the regularized, simple model, estimated on the treated, $\\hat{M}_1$.  The treatment effect it imputes is non linear, since it **doesn't** capture the non-linearity in the Y variable.\n",
    " \n",
    "In contrast, the blue dots are the imputed treatment effect for the treated, $\\hat{\\tau}(X, T=1)$. These effects are estimated using the correct model, $M_0$, trained in the untreated, large, sample. As a result, since its imputed treatment effects are correct, we are able to train a correct second stage model $\\hat{M}_{\\tau 1}(X)$, shown by the blue line. \n",
    " \n",
    "![img](data/img/meta-learners/second-stage-x.png)\n",
    " \n",
    "So we have one model that is wrong because we've impute the treatment effects wrongly and another model that is correct because we've imputed those values correctly. Now, we need a way to combine the two in a way that gives more weight to the correct model. Here is where the propensity score model comes to play. Let $\\hat{e}(x)$ be the propensity score model, we can combine the two second stage models as follows:\n",
    " \n",
    "$\n",
    "\\hat{\\tau(x)} = \\hat{M}_{\\tau 0}(X)\\hat{e}(x) +  \\hat{M}_{\\tau 1}(X)(1-\\hat{e}(x))\n",
    "$\n",
    " \n",
    "Since there are very few treated units, $\\hat{e}(x)$ is very small. This will give a very small weight to the wrong model $\\hat{M}_{\\tau 0}(X)$. \n",
    "\n",
    "In contrast, $1-\\hat{e}(x)$ is close to one, so we will give a high weight to the correct model $\\hat{M}_{\\tau 1}(X)$. More generally, weighted average using the propensity score will make sure we give more weight to the CATE model that was estimated where the assigned treatment was more likely. In other words, we will favor the model that was trained using more data. The following image shows the estimated CATE given by the X-learner and the T-learner.\n",
    " \n",
    "![img](data/img/meta-learners/t-vs-x-learner.png)\n",
    " \n",
    "As we can see, compared to the T-learner, the X-learner does a much better job in correcting the wrong CATE estimated at the non linearity. In general the X-learner performs better when a treatment group is much larger than the other. \n",
    " \n",
    "I know this might be a mouthful, but it will hopefully be clear once we move to the implementation. Just to summarize everything, here is the diagram of this learner.\n",
    " \n",
    "![img](data/img/meta-learners/x-learner.png)\n",
    " \n",
    "To the code at last! First, we have the first stage, which is exactly the same as the T-Learner. "
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 9,
   "metadata": {
    "ExecuteTime": {
     "end_time": "2023-07-27T11:43:10.027952Z",
     "start_time": "2023-07-27T11:43:09.860112Z"
    }
   },
   "outputs": [],
   "source": [
    "from sklearn.linear_model import LogisticRegression\n",
    "\n",
    "np.random.seed(123)\n",
    "\n",
    "# first stage models\n",
    "m0 = LGBMRegressor(max_depth=2, min_child_samples=30)\n",
    "m1 = LGBMRegressor(max_depth=2, min_child_samples=30)\n",
    "\n",
    "# propensity score model\n",
    "g = LogisticRegression(solver=\"lbfgs\", penalty='none') \n",
    "\n",
    "m0.fit(train.query(f\"{T}==0\")[X], train.query(f\"{T}==0\")[y])\n",
    "m1.fit(train.query(f\"{T}==1\")[X], train.query(f\"{T}==1\")[y])\n",
    "                       \n",
    "g.fit(train[X], train[T]);"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Now, we impute the treatment effect and fit the second stage models on them. "
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 10,
   "metadata": {
    "ExecuteTime": {
     "end_time": "2023-07-27T11:43:10.142397Z",
     "start_time": "2023-07-27T11:43:10.031958Z"
    }
   },
   "outputs": [],
   "source": [
    "d_train = np.where(train[T]==0,\n",
    "                   m1.predict(train[X]) - train[y],\n",
    "                   train[y] - m0.predict(train[X]))\n",
    "\n",
    "# second stage\n",
    "mx0 = LGBMRegressor(max_depth=2, min_child_samples=30)\n",
    "mx1 = LGBMRegressor(max_depth=2, min_child_samples=30)\n",
    "\n",
    "mx0.fit(train.query(f\"{T}==0\")[X], d_train[train[T]==0])\n",
    "mx1.fit(train.query(f\"{T}==1\")[X], d_train[train[T]==1]);"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Finally, we make corrected predictions using the propensity score model. "
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 11,
   "metadata": {
    "ExecuteTime": {
     "end_time": "2023-07-27T11:43:10.183379Z",
     "start_time": "2023-07-27T11:43:10.143573Z"
    }
   },
   "outputs": [],
   "source": [
    "def ps_predict(df, t): \n",
    "    return g.predict_proba(df[X])[:, t]\n",
    "    \n",
    "    \n",
    "x_cate_train = (ps_predict(train,1)*mx0.predict(train[X]) +\n",
    "                ps_predict(train,0)*mx1.predict(train[X]))\n",
    "\n",
    "x_cate_test = test.assign(cate=(ps_predict(test,1)*mx0.predict(test[X]) +\n",
    "                                ps_predict(test,0)*mx1.predict(test[X])))"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Lets see how our X-Learner does in the test. Again, let's plot the cumulative gain curve. "
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 12,
   "metadata": {
    "ExecuteTime": {
     "end_time": "2023-07-27T11:43:10.382425Z",
     "start_time": "2023-07-27T11:43:10.184785Z"
    },
    "tags": [
     "hide-input"
    ]
   },
   "outputs": [
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "/Users/matheus.facure/Documents/python-causality-handbook/causal-inference-for-the-brave-and-true/nb21.py:10: RuntimeWarning: invalid value encountered in double_scalars\n",
      "  np.sum((data[t] - data[t].mean())**2))\n"
     ]
    },
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<Figure size 432x288 with 1 Axes>"
      ]
     },
     "metadata": {
      "needs_background": "light"
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "gain_curve_test = cumulative_gain(x_cate_test, \"cate\", y=\"converted\", t=\"em1\")\n",
    "gain_curve_train = cumulative_gain(train.assign(cate=x_cate_train), \"cate\", y=\"converted\", t=\"em1\")\n",
    "plt.plot(gain_curve_test, color=\"C0\", label=\"Test\")\n",
    "plt.plot(gain_curve_train, color=\"C1\", label=\"Train\")\n",
    "plt.plot([0, 100], [0, elast(test, \"converted\", \"em1\")], linestyle=\"--\", color=\"black\", label=\"Baseline\")\n",
    "plt.legend();\n",
    "plt.title(\"X-Learner\");"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Once more, we have an OK performance on this dataset. Here, the S, T and X learners seem to perform pretty similarly. Still, I think it is worth knowing about all these meta learners so you can use whatever works best for you. Keep in mind that the performance is also highly dependent on the base machine learning model we choose. Here, we did everything using Gradient Boosted Trees, but maybe something else or even the same thing with different hyperparameters might work better. \n",
    " \n",
    "## Key Ideas\n",
    " \n",
    "Again, the simplest thing we can do is using a single or S-learner with the treatment as a feature. This tends to work well when the treatment is not a weak predictor of the outcome. But if that's not the case, the S-learner tends to be biased towards zero or even drop the treatment entirely. Adding a bit more complexity, we can force the learner to pick up the treatment by using a T-learner. Here, we fit one Machine Learning model per treatment level. This works fine when there are enough samples for all treatment levels, but it can fail when one treatment level has a small sample size, forcing a model to be heavily regularized. To fix that, we can add another level of complexity using an X-learner, where we have two fitting stages and we use a propensity score model to correct potential mistakes from models estimated with very few data points.\n",
    " \n",
    "One big problem of these learners (except the S-learner) is that they assume a binary or categorical treatment. There is one additional learner that we haven't seen yet, which is more general: the R-learner. But don't worry, we will have an entire chapter dedicated to it. \n",
    " \n",
    "## References \n",
    " \n",
    "The things I've written here are mostly stuff from my head. I've learned them through experience. This means that they have **not** passed the academic scrutiny that good science often goes through. Instead, notice how I'm talking about things that work in practice, but I don't spend too much time explaining why that is the case. It's a sort of science from the streets, if you will. However, I am putting this up for public scrutiny, so, by all means, if you find something preposterous, open an issue and I'll address it to the best of my efforts.\n",
    " \n",
    "To write this chapter, I've relied on Uber's *causalml* library and their documentation on meta learners. I've also took a lot of images and concept from Kunzela et al (2019), *Metalearners for estimating heterogeneous treatment effects using machine learning*. Finally, the discussion on the S-learner being biased towards zero was taken from Chernozhukov et al (2017), *Double/Debiased Machine Learning for Treatment and Causal Parameters*.\n",
    " \n",
    "## Contribute\n",
    " \n",
    "Causal Inference for the Brave and True is an open-source material on causal inference, the statistics of science. It uses only free software, based in Python. Its goal is to be accessible monetarily and intellectually.\n",
    "If you found this book valuable and you want to support it, please go to [Patreon](https://www.patreon.com/causal_inference_for_the_brave_and_true). If you are not ready to contribute financially, you can also help by fixing typos, suggesting edits or giving feedback on passages you didn't understand. Just go to the book's repository and [open an issue](https://github.com/matheusfacure/python-causality-handbook/issues). Finally, if you liked this content, please share it with others who might find it useful and give it a [star on GitHub](https://github.com/matheusfacure/python-causality-handbook/stargazers)."
   ]
  }
 ],
 "metadata": {
  "celltoolbar": "Tags",
  "kernelspec": {
   "display_name": "Python [conda env:root] *",
   "language": "python",
   "name": "conda-root-py"
  },
  "language_info": {
   "codemirror_mode": {
    "name": "ipython",
    "version": 3
   },
   "file_extension": ".py",
   "mimetype": "text/x-python",
   "name": "python",
   "nbconvert_exporter": "python",
   "pygments_lexer": "ipython3",
   "version": "3.7.12"
  },
  "toc": {
   "base_numbering": 1,
   "nav_menu": {},
   "number_sections": true,
   "sideBar": true,
   "skip_h1_title": false,
   "title_cell": "Table of Contents",
   "title_sidebar": "Contents",
   "toc_cell": false,
   "toc_position": {},
   "toc_section_display": true,
   "toc_window_display": false
  },
  "varInspector": {
   "cols": {
    "lenName": 16,
    "lenType": 16,
    "lenVar": 40
   },
   "kernels_config": {
    "python": {
     "delete_cmd_postfix": "",
     "delete_cmd_prefix": "del ",
     "library": "var_list.py",
     "varRefreshCmd": "print(var_dic_list())"
    },
    "r": {
     "delete_cmd_postfix": ") ",
     "delete_cmd_prefix": "rm(",
     "library": "var_list.r",
     "varRefreshCmd": "cat(var_dic_list()) "
    }
   },
   "types_to_exclude": [
    "module",
    "function",
    "builtin_function_or_method",
    "instance",
    "_Feature"
   ],
   "window_display": false
  }
 },
 "nbformat": 4,
 "nbformat_minor": 4
}
